home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2002 November / SGI IRIX Base Documentation 2002 November.iso / usr / share / catman / p_man / cat3 / Xt / XtDisplayInitialize.z / XtDisplayInitialize
Encoding:
Text File  |  2002-10-03  |  9.5 KB  |  199 lines
  1.  
  2.  
  3.  
  4.      XXXXttttDDDDiiiissssppppllllaaaayyyyIIIInnnniiiittttiiiiaaaalllliiiizzzzeeee((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXttttDDDDiiiissssppppllllaaaayyyyIIIInnnniiiittttiiiiaaaalllliiiizzzzeeee((((3333XXXXtttt))))
  5.  
  6.  
  7.  
  8.      NNNNAAAAMMMMEEEE
  9.           XtDisplayInitialize, XtOpenDisplay, XtDatabase,
  10.           XtScreenDatabase, XtCloseDisplay - initialize, open, or
  11.           close a display
  12.  
  13.      SSSSYYYYNNNNTTTTAAAAXXXX
  14.           void XtDisplayInitialize(_a_p_p__c_o_n_t_e_x_t, _d_i_s_p_l_a_y,
  15.           _a_p_p_l_i_c_a_t_i_o_n__n_a_m_e, _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s,
  16.                                  _o_p_t_i_o_n_s, _n_u_m__o_p_t_i_o_n_s, _a_r_g_c, _a_r_g_v)
  17.                 XtAppContext _a_p_p__c_o_n_t_e_x_t;
  18.                 Display *_d_i_s_p_l_a_y;
  19.                 String _a_p_p_l_i_c_a_t_i_o_n__n_a_m_e;
  20.                 String _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s;
  21.                 XrmOptionDescRec *_o_p_t_i_o_n_s;
  22.                 Cardinal _n_u_m__o_p_t_i_o_n_s;
  23.                 int *_a_r_g_c;
  24.                 String *_a_r_g_v;
  25.  
  26.           Display *XtOpenDisplay(_a_p_p__c_o_n_t_e_x_t, _d_i_s_p_l_a_y__s_t_r_i_n_g,
  27.           _a_p_p_l_i_c_a_t_i_o_n__n_a_m_e, _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s,
  28.                                  _o_p_t_i_o_n_s, _n_u_m__o_p_t_i_o_n_s, _a_r_g_c, _a_r_g_v)
  29.                  XtAppContext _a_p_p__c_o_n_t_e_x_t;
  30.                  String _d_i_s_p_l_a_y__s_t_r_i_n_g;
  31.                  String _a_p_p_l_i_c_a_t_i_o_n__n_a_m_e;
  32.                  String _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s;
  33.                  XrmOptionDescRec *_o_p_t_i_o_n_s;
  34.                  Cardinal _n_u_m__o_p_t_i_o_n_s;
  35.                  int *_a_r_g_c;
  36.                  String *_a_r_g_v;
  37.  
  38.           void XtCloseDisplay(_d_i_s_p_l_a_y)
  39.                 Display *_d_i_s_p_l_a_y;
  40.  
  41.           XrmDatabase XtDatabase(_d_i_s_p_l_a_y)
  42.                 Display *_d_i_s_p_l_a_y;
  43.  
  44.           XrmDatabase XtScreenDatabase(_s_c_r_e_e_n)
  45.                 Screen* _s_c_r_e_e_n;
  46.  
  47.      AAAARRRRGGGGUUUUMMMMEEEENNNNTTTTSSSS
  48.           _a_r_g_c      Specifies a pointer to the number of command line
  49.                     parameters.
  50.  
  51.           _a_r_g_v      Specifies the command line parameters.
  52.  
  53.           _a_p_p__c_o_n_t_e_x_t
  54.                     Specifies the application context.
  55.  
  56.           _a_p_p_l_i_c_a_t_i_o_n__c_l_a_s_s
  57.                     Specifies the class name of this application,
  58.                     which usually is the generic name for all
  59.                     instances of this application.
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 10/3/02)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      XXXXttttDDDDiiiissssppppllllaaaayyyyIIIInnnniiiittttiiiiaaaalllliiiizzzzeeee((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXttttDDDDiiiissssppppllllaaaayyyyIIIInnnniiiittttiiiiaaaalllliiiizzzzeeee((((3333XXXXtttt))))
  71.  
  72.  
  73.  
  74.           _a_p_p_l_i_c_a_t_i_o_n__n_a_m_e
  75.                     Specifies the name of the application instance.
  76.  
  77.           _d_i_s_p_l_a_y   Specifies the display.  Note that a display can be
  78.                     in at most one application context.
  79.  
  80.           _n_u_m__o_p_t_i_o_n_s
  81.                     Specifies the number of entries in the options
  82.                     list.
  83.  
  84.           _o_p_t_i_o_n_s   Specifies how to parse the command line for any
  85.                     application-specific resources.  The options
  86.                     argument is passed as a parameter to
  87.                     _X_r_m_P_a_r_s_e_C_o_m_m_a_n_d.  For further information, see
  88.                     _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e.
  89.  
  90.           _s_c_r_e_e_n    Specifies the screen whose resource database is to
  91.                     be returned.
  92.  
  93.      DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  94.           The _X_t_D_i_s_p_l_a_y_I_n_i_t_i_a_l_i_z_e function builds the resource
  95.           database, calls the Xlib _X_r_m_P_a_r_s_e_C_o_m_m_a_n_d function to parse
  96.           the command line, and performs other per display
  97.           initialization.  After _X_r_m_P_a_r_s_e_C_o_m_m_a_n_d has been called, argc
  98.           and argv contain only those parameters that were not in the
  99.           standard option table or in the table specified by the
  100.           options argument.  If the modified argc is not zero, most
  101.           applications simply print out the modified argv along with a
  102.           message listing the allowable options.  On UNIX-based
  103.           systems, the application name is usually the final component
  104.           of argv[0].  If the synchronize resource is _T_r_u_e for the
  105.           specified application, _X_t_D_i_s_p_l_a_y_I_n_i_t_i_a_l_i_z_e calls the Xlib
  106.           _X_S_y_n_c_h_r_o_n_i_z_e function to put Xlib into synchronous mode for
  107.           this display connection.  If the reverseVideo resource is
  108.           _T_r_u_e, the Intrinsics exchange _X_t_D_e_f_a_u_l_t_F_o_r_e_g_r_o_u_n_d and
  109.           _X_t_D_e_f_a_u_l_t_B_a_c_k_g_r_o_u_n_d for widgets created on this display.
  110.           (See Section 9.6.1).
  111.  
  112.           The _X_t_O_p_e_n_D_i_s_p_l_a_y function calls _X_O_p_e_n_D_i_s_p_l_a_y the specified
  113.           display name.  If display_string is NULL, _X_t_O_p_e_n_D_i_s_p_l_a_y uses
  114.           the current value of the -display option specified in argv
  115.           and if no display is specified in argv, uses the user's
  116.           default display (on UNIX-based systems, this is the value of
  117.           the DISPLAY environment variable).
  118.  
  119.           If this succeeds, it then calls _X_t_D_i_s_p_l_a_y_I_n_i_t_i_a_l_i_z_e and pass
  120.           it the opened display and the value of the -name option
  121.           specified in argv as the application name.  If no name
  122.           option is specified, it uses the application name passed to
  123.           _X_t_O_p_e_n_D_i_s_p_l_a_y.  If the application name is NULL, it uses the
  124.           last component of argv[0].  _X_t_O_p_e_n_D_i_s_p_l_a_y returns the newly
  125.           opened display or NULL if it failed.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 10/3/02)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      XXXXttttDDDDiiiissssppppllllaaaayyyyIIIInnnniiiittttiiiiaaaalllliiiizzzzeeee((((3333XXXXtttt))))XXXX VVVVeeeerrrrssssiiiioooonnnn 11111111 ((((RRRReeeelllleeeeaaaasssseeee 6666....6666))))XXXXttttDDDDiiiissssppppllllaaaayyyyIIIInnnniiiittttiiiiaaaalllliiiizzzzeeee((((3333XXXXtttt))))
  137.  
  138.  
  139.  
  140.           _X_t_O_p_e_n_D_i_s_p_l_a_y is provided as a convenience to the
  141.           application programmer.
  142.  
  143.           The _X_t_C_l_o_s_e_D_i_s_p_l_a_y function closes the specified display as
  144.           soon as it is safe to do so.  If called from within an event
  145.           dispatch (for example, a callback procedure), _X_t_C_l_o_s_e_D_i_s_p_l_a_y
  146.           does not close the display until the dispatch is complete.
  147.           Note that applications need only call _X_t_C_l_o_s_e_D_i_s_p_l_a_y if they
  148.           are to continue executing after closing the display;
  149.           otherwise, they should call _X_t_D_e_s_t_r_o_y_A_p_p_l_i_c_a_t_i_o_n_C_o_n_t_e_x_t or
  150.           just exit.
  151.  
  152.           The _X_t_D_a_t_a_b_a_s_e function returns the fully merged resource
  153.           database that was built by _X_t_D_i_s_p_l_a_y_I_n_i_t_i_a_l_i_z_e associated
  154.           with the display that was passed in.  If this display has
  155.           not been initialized by _X_t_D_i_s_p_l_a_y_I_n_i_t_i_a_l_i_z_e, the results are
  156.           not defined.
  157.  
  158.           The _X_t_S_c_r_e_e_n_D_a_t_a_b_a_s_e function returns the fully merged
  159.           resource database associated with the specified screen. If
  160.           the _s_c_r_e_e_n does not belong to a _D_i_s_p_l_a_y initilized by
  161.           _X_t_D_i_s_p_l_a_y_I_n_i_t_i_a_l_i_z_e, the results are undefined.
  162.  
  163.      SSSSEEEEEEEE AAAALLLLSSSSOOOO
  164.           XtAppCreateShell(3Xt), XtCreateApplicationContext(3Xt)
  165.           _X _T_o_o_l_k_i_t _I_n_t_r_i_n_s_i_c_s - _C _L_a_n_g_u_a_g_e _I_n_t_e_r_f_a_c_e
  166.           _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 10/3/02)
  196.  
  197.  
  198.  
  199.